IUMagString

Compare text for international sorting

short IUMagString(ptrA, ptrB, lenA, lenB );

Ptr strA ; addresses of unformatted ...

Ptr strB ; ... text to compare

short lenA ; length of strA, in bytes

short lenB ; length of strB, in bytes

returns -1 if (ab)

IUMagString compares two blocks of text and indicates which is greater or

if they are equal. It takes into consideration such international characteristics

as diacritical marks and ligatures. It DOES differentiate between upper- and

lowercase.

strA and . . .

strB are the addresses of unformatted text to be compared.

lenA is the length, in bytes, of strA.

lenB is the length, in bytes, of strB.

Returns: a signed integer; it describes the collating relationship of strA and

strB. It is one of:

-1 strA is less than strB

0 strA and strB are equal

1 strA is greater than strB

Notes: The return code is the same as used by the familiar C strcmp function and

as with strcmp, a short string is always seen as less than a long string.

IUMagString may be overkill for your application, but should be used

for international compatibility. It is less efficient than a direct ASCII sort,

as it has to lookup the "collating weight" of each character of each string.

To compare pascal-style length-prefixed strings, use IUCompString.

For case-insensitive equality testing (as when matching file names), use

Referenced by (11):